MarkLogic Server 11.0 Product Documentation
DELETE /manage/v2/roles/{id|name}

Summary

This resource address deletes the named role from the named security database.

URL Parameters
format	The format of the posted data. Can be either `html`, `json`, or `xml` (default). This parameter is not meaningful with `view=edit`. This value overrides the Accept header if both are present.

Request Headers
Accept	The expected MIME type of the response. If the `format` parameter is present, it takes precedence over the Accept header.

Response

Upon successful completion, MarkLogic Server returns status code 204 (No Content). If the role does not exist, a status code of 400 (Bad Request) is returned. A status code of 401 (Unauthorized) is returned if the user does not have the necessary privileges.

Required Privileges

This operation requires one of the following:

the manage-admin and security role
the following privileges:
http://marklogic.com/xdmp/privileges/manage

http://marklogic.com/xdmp/privileges/manage-admin

http://marklogic.com/xdmp/privileges/remove-role

http://marklogic.com/xdmp/privileges/remove-role-from-users

http://marklogic.com/xdmp/privileges/remove-role-from-roles

http://marklogic.com/xdmp/privileges/remove-role-from-privileges

http://marklogic.com/xdmp/privileges/remove-role-from-amps
the manage role, http://marklogic.com/xdmp/privileges/manage plus the following granular privileges:
- http://marklogic.com/xdmp/privileges/create-data-role
- http://marklogic.com/xdmp/privileges/role/edit/role-ID

Example


curl -X DELETE --anyauth -u admin:admin -H "Content-Type:application/json" \
http://localhost:8002/manage/v2/roles/engineer?

==>  Deletes the role, "engineer," from the Security database.

MarkLogic Server 11.0 Product DocumentationDELETE /manage/v2/roles/{id|name}

Summary

Response

Required Privileges

Example

MarkLogic Server 11.0 Product Documentation
DELETE /manage/v2/roles/{id|name}